git.openwrt.org Git - openwrt/openwrt.git/blob

   1 From fdcc587a966119260fb7f29406001f0ae2bda34e Mon Sep 17 00:00:00 2001
   2 From: Dave Stevenson <dave.stevenson@raspberrypi.com>
   3 Date: Thu, 22 Dec 2022 14:08:35 +0000
   4 Subject: [PATCH] dtbindings: media: i2c: Add IMX708 CMOS sensor binding
   5
   6 Add YAML devicetree binding for IMX708 CMOS image sensor.
   7 Let's also add a MAINTAINERS entry for the binding and driver.
   8
   9 Signed-off-by: Dave Stevenson <dave.stevenson@raspberrypi.com>
  10 ---
  11  .../devicetree/bindings/media/i2c/imx708.yaml | 119 ++++++++++++++++++
  12  MAINTAINERS                                   |   8 ++
  13  2 files changed, 127 insertions(+)
  14  create mode 100644 Documentation/devicetree/bindings/media/i2c/imx708.yaml
  15
  16 --- /dev/null
  17 +++ b/Documentation/devicetree/bindings/media/i2c/imx708.yaml
  18 @@ -0,0 +1,119 @@
  19 +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  20 +%YAML 1.2
  21 +---
  22 +$id: http://devicetree.org/schemas/media/i2c/imx708.yaml#
  23 +$schema: http://devicetree.org/meta-schemas/core.yaml#
  24 +
  25 +title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
  26 +
  27 +maintainers:
  28 +  - Naushir Patuck <naush@raspberypi.com>
  29 +
  30 +description: |-
  31 +  The Sony IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
  32 +  with an active array size of 4608H x 2592V. It is programmable through
  33 +  I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
  34 +  Image data is sent through MIPI CSI-2, which is configured as either 2 or
  35 +  4 data lanes.
  36 +
  37 +properties:
  38 +  compatible:
  39 +    const: sony,imx708
  40 +
  41 +  reg:
  42 +    description: I2C device address
  43 +    maxItems: 1
  44 +
  45 +  clocks:
  46 +    maxItems: 1
  47 +
  48 +  VDIG-supply:
  49 +    description:
  50 +      Digital I/O voltage supply, 1.1 volts
  51 +
  52 +  VANA1-supply:
  53 +    description:
  54 +      Analog1 voltage supply, 2.8 volts
  55 +
  56 +  VANA2-supply:
  57 +    description:
  58 +      Analog2 voltage supply, 1.8 volts
  59 +
  60 +  VDDL-supply:
  61 +    description:
  62 +      Digital core voltage supply, 1.8 volts
  63 +
  64 +  reset-gpios:
  65 +    description: |-
  66 +      Reference to the GPIO connected to the xclr pin, if any.
  67 +      Must be released (set high) after all supplies and INCK are applied.
  68 +
  69 +  # See ../video-interfaces.txt for more details
  70 +  port:
  71 +    type: object
  72 +    properties:
  73 +      endpoint:
  74 +        type: object
  75 +        properties:
  76 +          data-lanes:
  77 +            description: |-
  78 +              The sensor supports either two-lane, or four-lane operation.
  79 +              For two-lane operation the property must be set to <1 2>.
  80 +            items:
  81 +              - const: 1
  82 +              - const: 2
  83 +
  84 +          clock-noncontinuous:
  85 +            type: boolean
  86 +            description: |-
  87 +              MIPI CSI-2 clock is non-continuous if this property is present,
  88 +              otherwise it's continuous.
  89 +
  90 +          link-frequencies:
  91 +            allOf:
  92 +              - $ref: /schemas/types.yaml#/definitions/uint64-array
  93 +            description:
  94 +              Allowed data bus frequencies.
  95 +
  96 +        required:
  97 +          - link-frequencies
  98 +
  99 +required:
 100 +  - compatible
 101 +  - reg
 102 +  - clocks
 103 +  - VANA1-supply
 104 +  - VANA2-supply
 105 +  - VDIG-supply
 106 +  - VDDL-supply
 107 +  - port
 108 +
 109 +additionalProperties: false
 110 +
 111 +examples:
 112 +  - |
 113 +    i2c0 {
 114 +        #address-cells = <1>;
 115 +        #size-cells = <0>;
 116 +
 117 +        imx708: sensor@1a {
 118 +            compatible = "sony,imx708";
 119 +            reg = <0x1a>;
 120 +            clocks = <&imx708_clk>;
 121 +            VANA1-supply = <&imx708_vana1>; /* 1.8v */
 122 +            VANA2-supply = <&imx708_vana2>; /* 2.8v */
 123 +            VDIG-supply = <&imx708_vdig>;   /* 1.1v */
 124 +            VDDL-supply = <&imx708_vddl>;   /* 1.8v */
 125 +
 126 +            port {
 127 +                imx708_0: endpoint {
 128 +                    remote-endpoint = <&csi1_ep>;
 129 +                    data-lanes = <1 2>;
 130 +                    clock-noncontinuous;
 131 +                    link-frequencies = /bits/ 64 <450000000>;
 132 +                };
 133 +            };
 134 +        };
 135 +    };
 136 +
 137 +...
 138 --- a/MAINTAINERS
 139 +++ b/MAINTAINERS
 140 @@ -21597,6 +21597,14 @@ T:     git git://linuxtv.org/media_tree.git
 141  F:     Documentation/devicetree/bindings/media/i2c/imx519.yaml
 142  F:     drivers/media/i2c/imx519.c
 143
 144 +SONY IMX708 SENSOR DRIVER
 145 +M:     Raspberry Pi Kernel Maintenance <kernel-list@raspberrypi.com>
 146 +L:     linux-media@vger.kernel.org
 147 +S:     Maintained
 148 +T:     git git://linuxtv.org/media_tree.git
 149 +F:     Documentation/devicetree/bindings/media/i2c/imx708.yaml
 150 +F:     drivers/media/i2c/imx708.c
 151 +
 152  SONY MEMORYSTICK SUBSYSTEM
 153  M:     Maxim Levitsky <maximlevitsky@gmail.com>
 154  M:     Alex Dubov <oakad@yahoo.com>